package com.kakarote.hrm.service;

import com.alibaba.fastjson.JSONObject;
import com.kakarote.common.log.entity.OperationLog;
import com.kakarote.core.entity.BasePage;
import com.kakarote.core.entity.UploadEntity;
import com.kakarote.core.servlet.BaseService;
import com.kakarote.hrm.entity.BO.QueryRecruitStartPositionPageListBO;
import com.kakarote.hrm.entity.PO.HrmRecruitStartPosition;
import com.kakarote.hrm.entity.VO.RecruitStartPositionVO;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;

/**
 * <p>
 * 招聘启动岗位 服务类
 * </p>
 *
 * @author system
 * @since 2024-01-01
 */
public interface IHrmRecruitStartPositionService extends BaseService<HrmRecruitStartPosition> {

    /**
     * 添加招聘启动岗位
     *
     * @param recruitStartPosition 招聘启动岗位
     * @return 操作日志
     */
    OperationLog addRecruitStartPosition(HrmRecruitStartPosition recruitStartPosition);

    /**
     * 修改招聘启动岗位
     *
     * @param recruitStartPosition 招聘启动岗位
     * @return 操作日志
     */
    OperationLog setRecruitStartPosition(HrmRecruitStartPosition recruitStartPosition);

    /**
     * 获取招聘启动岗位详情
     *
     * @param startPositionId 启动岗位id
     * @return 岗位详情
     */
    RecruitStartPositionVO queryById(Long startPositionId);

    /**
     * 查询招聘启动岗位列表
     *
     * @param queryRecruitStartPositionPageListBO 查询条件
     * @return 分页结果
     */
    BasePage<RecruitStartPositionVO> queryRecruitStartPositionPageList(QueryRecruitStartPositionPageListBO queryRecruitStartPositionPageListBO);

    /**
     * 根据计划id查询所有启动岗位列表
     *
     * @param planId 计划id
     * @return 岗位列表
     */
    List<RecruitStartPositionVO> queryByPlanId(Long planId);

    /**
     * 根据记录id查询所有启动岗位列表
     *
     * @param recordId 记录id
     * @return 岗位列表
     */
    List<RecruitStartPositionVO> queryByRecordId(Long recordId);

    /**
     * 删除招聘启动岗位
     *
     * @param startPositionId 启动岗位id
     * @return 操作日志
     */
    OperationLog deleteRecruitStartPosition(Long startPositionId);

    /**
     * 批量删除招聘启动岗位
     *
     * @param startPositionIds 启动岗位id列表
     * @return 操作日志
     */
    OperationLog batchDeleteRecruitStartPosition(List<Long> startPositionIds);

    /**
     * 根据计划id删除所有启动岗位
     *
     * @param planId 计划id
     * @return 操作日志
     */
    OperationLog deleteByPlanId(Long planId);

    /**
     * 根据记录id删除所有启动岗位
     *
     * @param recordId 记录id
     * @return 操作日志
     */
    OperationLog deleteByRecordId(Long recordId);

    /**
     * 导出招聘启动岗位
     *
     * @param response                           HTTP响应
     * @param queryRecruitStartPositionPageListBO 查询条件
     * @throws IOException IO异常
     */
    void exportRecruitStartPosition(HttpServletResponse response, QueryRecruitStartPositionPageListBO queryRecruitStartPositionPageListBO) throws IOException;

    /**
     * 下载导入模板
     *
     * @param response HTTP响应
     * @throws IOException IO异常
     */
    void downloadExcel(HttpServletResponse response) throws IOException;

    /**
     * Excel导入招聘启动岗位
     *
     * @param file 文件
     * @return 导入结果
     */
    JSONObject excelImport(MultipartFile file);

    /**
     * 上传临时文件
     *
     * @param file   文件
     * @param batchId 批次ID
     * @return 上传结果
     */
    UploadEntity uploadTempFile(MultipartFile file, String batchId);
}
